home *** CD-ROM | disk | FTP | other *** search
/ PC-SIG: World of Education / PC-SiG's World of Education.iso / wor / disk2333.zip / READ.DOC < prev    next >
Text File  |  1991-04-15  |  65KB  |  1,837 lines

  1.               INTRODUCTION
  2.  
  3. Readability Plus analyzes your writing using of a sophisticated
  4. language analysis system that identifies sentences that aren't
  5. appropriate for particular kinds of writing.  It helps YOU ensure
  6. that what you've written will be interesting and easily understood
  7. by your intended audience.  And it will help eliminate the frustration
  8. you feel when you have to rewrite a document over and over again because
  9. your supervisor or teacher doesn't like it.  It is not a spelling
  10. checker or a grammar checker.  But grammar checkers won't do what
  11. Readability Plus does.  In fact, our software assumes that what you've
  12. written is already "mechanically" correct.  It takes the approach that
  13. documents that are grammatically correct still can be very boring.  Our
  14. software analyzes more than 25 aspects of writing that makes your text
  15. "sing" to your readers!  Except for the more powerful upgrade,
  16. Corporate Voice, Readability Plus is the only program for PCs and
  17. compatibles that tailors its suggestions to different styles of writing.
  18. And unless you think that a research paper and a love letter
  19. should be written the same way, you'll find Readability Plus to
  20. be one of your most valuable writing tools.
  21.  
  22. Even if you're already a good writer, Readability Plus still can
  23. provide you with valuable assistance by helping you tailor your
  24. writing to the audience you're trying to reach.  And if you're
  25. not particularly proud of your writing skills, the program can
  26. save you hours of revision time and embarrassment by identifying
  27. the sentences your manager, teacher, or editor is sure to
  28. criticize.
  29.  
  30.  
  31. Features
  32.  
  33. Readability Plus directly reads files created with WordPerfect Version
  34. 5.0, Microsoft Word Version 4.0, WordStar Version 5.0, and WordStar 2000;
  35. it can also read any ASCII (text) file.
  36.  
  37. Readability Plus generates four readability indices:  the
  38. Flesch-Kincaid Index, the Flesch Reading Ease Index, Gunning's
  39. Fog Index, and LIX (the technical name for RIX).
  40.  
  41. Readability Plus does a "mortar and bricks" analysis based on
  42. the most common English words.  There are three measures of
  43. "mortar:  comparing your writing to the words that comprise 20%
  44. of most English text, the 450 words that comprise 60%, and the
  45. 2450 words that comprise 80% of most writing.  Similarly,
  46. Readability Plus will analyze the "bricks" (difficult words)
  47. percentages against words not found on the list of the 80% Most
  48. Common Words (which has 2450 words).
  49.  
  50. The program's displays include:
  51.  
  52. ..  "Teardrop" or style diagram of the text (Display 11)
  53. ..  Percentages of the nine different types of sentences
  54.     (Displays 12 and 31).
  55. ..  Long words per sentence (Displays 13 and 32).
  56. ..  Words per sentence (Displays 14 and 33).
  57. ..  Consecutive short words (Display 15).
  58. ..  Consecutive long words (Display 16).
  59. ..  Word lengths (Display 21).
  60. ..  Bricks that have been used in the text (Display 22).
  61. ..  Ratio of bricks to mortar (Display 23).
  62. ..  Comments on word choice (Display 24).
  63. ..  Overall evaluation I (Display 40)
  64. ..  General evaluation II (Display 41).
  65.  
  66. ..  General comments and tips on how to make your writing more
  67.     readable (Display 42).
  68. ..  Number of sentences and words in your text (Display 43).
  69.  
  70.  
  71.                YOUR FIRST SESSION
  72.  
  73. If you've made a backup copy of your original diskette, you can
  74. proceed with your first Readability Plus session.  This section
  75. presents instructions on how to conduct a simple analysis of a
  76. text and examine the results.
  77.  
  78. If you do not have a hard disk, remember that you should work
  79. with a copy of the program diskette and not with the original.
  80.  
  81.  
  82.               PREPARATIONS
  83.  
  84. ..  Start the computer.
  85.  
  86. If you only have diskette drives:
  87.  
  88. ..  Insert the copy of the Readability Plus diskette in diskette
  89.     drive A.
  90.  
  91. ..  Type:
  92.  
  93.  read
  94.  
  95. ..  Press Enter.
  96.  
  97. If you have a hard disk, copy the diskette or files to a
  98. directory you've already created and named (for instance)
  99. READPLUS.  Log into that subdirectory and type:
  100.  
  101.  read
  102.  
  103. ..  Press Enter.
  104.  
  105. When you have successfully loaded the program, the main menu
  106. will appear on your screen.
  107.  
  108.  
  109.                BACKING OUT WITH F1
  110.  
  111. In Readability Plus, you can always try out something to see
  112. what will happen.  This makes it easier to explore the function
  113. keys and menus.  If something unexpected happens, you can always
  114. back out of the situation very easily by pressing F1.  This will
  115. take you back where you were without any changes having been
  116. made.  If you press F1 repeatedly, you will be returned to the
  117. main menu.
  118.  
  119.  
  120.  
  121.             IF YOU NEED HELP
  122.  
  123. Readability Plus has a built-in help function (F10) that
  124. provides you with brief, helpful information while you are
  125. working.  Also, once you register your copy, you can receive
  126. additional support by calling 1-301-294-7453 and giving the
  127. representative your registration number.
  128.  
  129.  
  130.           BRIEF REVIEW OF THE MAIN MENU
  131.  
  132. You may select options from the main menu in two ways:
  133.  
  134. ..  Type the desired number (1, 2, 3, 9 or 0).
  135. ..  Press Enter.
  136.  
  137. You can, however, speed things up a little by using the function
  138. keys:
  139.  
  140. ..  Press the desired function key (F1, F2, F3, or F9).
  141.  
  142. Note that if you wish to exit the program, you must still
  143. press 0.
  144.  
  145.  
  146. Option 1 -- How Readability Plus Works
  147.  
  148. When the main menu appears on the screen:
  149.  
  150. ..  Press F1.
  151.  
  152. Information about the following will appear:
  153.  
  154. ..  The files that you can analyze.
  155. ..  How you can eliminate parts of a text to improve analysis.
  156.  
  157. Both of the above are discussed in greater detail in the next
  158. section.
  159.  
  160. ..  Press any key to return to the main menu.
  161.  
  162.  
  163. Option 2 -- Analyze a Text
  164.  
  165. When you select Option 2 (Analyze a Text), you must type the
  166. following:
  167.  
  168. ..  Where the program can find the text (disk drive,
  169.     subdirectory).
  170. ..  The name of the text (filename).
  171. ..  Where the results are to be stored.
  172. ..  Which analysis pattern you wish to have the text compared
  173.     with.
  174.  
  175. In addition, you can type:
  176.  
  177. ..  A title, so that you can easily identify the text when you
  178.     look at the results later.
  179.  
  180.  
  181. You can look at a list of all the files that can be analyzed or
  182. a list of the files that have been previously analyzed.  You can
  183. also look at texts located on other disks (hard disk or
  184. diskettes) in other drives.
  185.  
  186.  
  187. Option 3 - Examine Results of Previous Analyses
  188.  
  189. When you select Option 3 (Look at the results of previous
  190. analyses), a list appears on the screen.  This list contains the
  191. names of the results of previous analyses.  You can also look at
  192. texts located on other disks (hard disk or diskettes) in other
  193. drives.
  194.  
  195.  
  196. Option 9 - Select Background Color
  197.  
  198. If you have a color monitor, you may choose between two color
  199. combinations:
  200.  
  201. ..  Black background with yellow and green text.
  202. ..  Blue background with yellow and green text.
  203. ..  Pressing F9 toggles you between the two color combinations.
  204.  
  205. If you have a single-color monitor, nothing happens when you
  206. press F9.
  207.  
  208.  
  209. Option 0 - Exit From Readability Plus
  210.  
  211. Press 0 to exit from Readability Plus.
  212.  
  213.  
  214.              USEFUL TIPS ON PRINTING
  215.  
  216. If a printer is connected to your computer you may, at any time,
  217. obtain a paper copy of the screen content.
  218.  
  219. Proceed as follows:
  220.  
  221. ..  Check that the printer is ON-LINE (ready for printing).
  222. ..  Hold down the Shift key and press PrtSc.
  223.  
  224. The screen content will be copied over onto the printer.  On
  225. some printers, certain special characters and boxes may not be
  226. printed out exactly as they appear on the screen since all
  227. printers do not support all of the graphics characters that are
  228. used.  However, the text should be the same as it appeared on
  229. the screen.
  230.  
  231.  
  232.             ANALYZING A TEXT
  233.  
  234. This section explains how to find out which files you can
  235. analyze with Readability Plus, how to eliminate parts of texts
  236. to improve analysis and how analysis is carried out.  It also
  237. explains the submenus that appear at the bottom of the screen.
  238.  
  239.  
  240.  
  241. Which Files Can You Analyze?
  242.  
  243. Texts that you can analyze must:
  244.  
  245. ..  Have been written using WordPerfect, Microsoft Word,
  246.     WordStar or WordStar 2000.
  247.  
  248. Or
  249.  
  250. ..  Have been written using some other word processing program
  251.     and then saved as, or converted to, an ASCII file.
  252.  
  253. Readability Plus can read directly files created with
  254. WordPerfect, Microsoft Word, WordStar, and Word Star 2000
  255. without having to translate them to ASCII.
  256.  
  257. Both WordPerfect (version 5.0 and above) and Microsoft Word
  258. (version 4.0 and above) place header records at the beginning of
  259. files they create that tell programs such as Readability Plus
  260. which word processor created them.  Therefore if you're using
  261. one of these packages, you don't have to do a thing. Readability
  262. Plus will "know" which format to use and will do the necessary
  263. translation on its own.
  264.  
  265. If your document was not created with one of those packages,
  266. just before the analysis begins, Readability Plus will display a
  267. message that says:
  268.  
  269.  FILE FORMAT
  270.  Please select your file format from one of the
  271.  following:
  272.  1.  ASCII file
  273.  2.  WordPerfect Version 4
  274.  3.  WordStar
  275.  4.  WordStar 2000
  276.  
  277. All you need to do in this case is press the corresponding key
  278. (1-4), and the program will begin the analysis.
  279.  
  280.  
  281. Analyzing ASCII or Text Files
  282.  
  283. When you save a text in ASCII format, all or most of the special
  284. characters are eliminated.  These can include the markings used
  285. for headings, bolding and underlining.  The specific special
  286. characters that are eliminated will depend on which word
  287. processing program you were using.
  288.  
  289. Most word processing programs include a program called "Convert"
  290. or something similar.  This program can be used to automatically
  291. eliminate the control characters that would otherwise disturb
  292. the Readability Plus analysis.  The converted file is called an
  293. ASCII file, although the word processing program in question may
  294. call it "DOS text", "plain text", "output file" or something
  295. similar.
  296.  
  297. Remember that it if you convert a text file to ASCII format, you
  298. should also save it in its original form.  This can be done
  299. using the "Save as" function in your word processing program or
  300. by first copying the file and then converting the copy.  You
  301.  
  302. should keep a copy of the original since when you convert to
  303. ASCII, you will loose most of or all of the special formatting
  304. codes that have been entered into the text.  Consequently, if
  305. you were to use it in your word processing program again, you
  306. would have to re-do a lot of work.
  307.  
  308. You can use the DOS command TYPE to see whether or not a file
  309. has become an ASCII file.  To look at the text file named
  310. EXAMPLE.ASC (which must be on the diskette in the default drive
  311. or in the default subdirectory on a hard disk) you can do as
  312. follows:
  313.  
  314. ..  Type:
  315.  
  316.  type example.asc
  317.  
  318. ..  Press Enter.
  319.  
  320. The text file named EXAMPLE.ASC will now be written on the
  321. screen if it's an ASCII file.  If you see strange characters,
  322. you haven't converted the file to ASCII properly.
  323.  
  324.  
  325.           READABILITY PLUS AND HEADINGS
  326.  
  327. You should always eliminate headings so that your analysis will
  328. be accurate.  If you do not do so, each heading may be chained
  329. to the sentence that immediately follows.
  330.  
  331. This is because Readability Plus defines the end of a sentence
  332. as follows:
  333.  
  334. ..  Period followed by an upper case letter.
  335. ..  Colon followed by an upper case letter.
  336. ..  Question mark followed by an upper case letter.
  337. ..  Exclamation point followed by an upper case letter.
  338. ..  Semicolon.
  339.  
  340. Since a period does not normally follow a heading, the heading
  341. is chained to the next sentence.  This causes the program to
  342. rate the sentence as being longer (and thus more difficult) than
  343. it really is.  However, if you put a period after the heading,
  344. the heading itself will be considered a sentence.
  345.  
  346.  
  347.         HOW TO ELIMINATE PARTS OF A TEXT
  348.  
  349. It is not necessary to analyze an entire text.  You can
  350. eliminate part of the text or different parts of the text.  This
  351. may be done by marking the parts of the text that are to be
  352. analyzed by means of special characters before starting
  353. analysis.
  354.  
  355. If you do not wish to eliminate one or more parts of your text,
  356. you may proceed to the section headed Starting Analysis.  If you
  357. do wish to eliminate one or more parts of your text, you should
  358. work with a copy of the text and not with the original.  If you
  359. work with the original, it means that you may have to change it
  360. back to its original form again.  If you work with a copy, the
  361. original will remain unchanged.
  362.  
  363. If Readability Plus has been loaded into your computer, the
  364. first thing to do is exit from the program.  To do this, proceed
  365. as follows:
  366.  
  367. ..  Press F1, whereupon the main menu will appear.
  368. ..  Press F10 to exit from Readability Plus.
  369.  
  370. Start your word processing program and load (retrieve) the text
  371. that you are going to analyze.  If you are not using
  372. WordPerfect, Microsoft Word, WordStar or WordStar 2000, you
  373. should retrieve the ASCII file that you have created.
  374.  
  375. ..  Move the cursor to the location immediately preceding the
  376.     text you wish to eliminate.
  377. ..  Hold down the Alt key and enter the following on the
  378.     numerical keypad located at right on most keyboards):
  379.  
  380.  244
  381.  
  382. ..  Release the Alt key.
  383.  
  384. You have now marked the beginning of the part of the text that
  385. is not to be analyzed with the ASCII "fish hook" character.
  386.  
  387. The end of the part of the text that is not to be analyzed must
  388. also be marked, but using a different character.
  389.  
  390. ..  Move the cursor to the location immediately after the part
  391.     of the text that is not to be analyzed.
  392.  
  393. ..  Hold down the Alt key and type the following on the
  394.     numerical keypad at right:
  395.  
  396.  245
  397.  
  398. ..  Release the Alt key.
  399.  
  400. You can use the same procedure again if you wish to eliminate
  401. additional parts of the text before starting the analysis.
  402.  
  403.  
  404.  
  405.               HOW TO ANALYZE A TEXT
  406.  
  407. Note!  Remember that the screen display examples shown in this
  408. manual may differ somewhat from those that actually appear on
  409. your screen.  The examples included here are for a
  410. diskette-drive system.  If you have a hard disk, you may see
  411. C:\READPLUS\ instead of A:\.
  412.  
  413. This section explains how to find out which files can be
  414. analyzed with Readability Plus and how the analysis is car- ried
  415. out.  It also explains the submenus that appear at the bottom of
  416. the screen.
  417.  
  418.           SELECTING FILES FOR ANALYSIS
  419.  
  420. When the main menu appears on the screen:
  421.  
  422. ..  Press F2.
  423.  
  424. A list of all the drives and a list of all the non-program files
  425. in the subdirectory you're logged onto will be shown.  PARENT
  426. (DIR) may also be displayed.  It is Readability Plus' way of
  427. telling you that there are directories and subdirectories on the
  428. disk that are "superior" (i.e., higher on the DOS tree) to the
  429. one you're in.  Files having the following filename extensions
  430. are not shown on the screen since these files do not normally
  431. contain text.
  432.  
  433.  .BAK
  434.  .BAS
  435.  .COM
  436.  .EXE
  437.  .FX
  438.  .FY
  439.  .FZ
  440.  .RDB
  441.  .SYS
  442.  
  443. Files extended with .FX, .FY and .FZ are created in Readability
  444. Plus when it analyzes a file.
  445.  
  446. If the text you are going to analyze is among those whose names
  447. are shown on the screen, proceed as follows:
  448.  
  449. ..  Use the arrow keys to highlight the desired text.
  450. ..  Press Enter.
  451.  
  452. If the file is in a directory that's not listed on the screen,
  453. first select PARENT (DIR) to get a full listing of the
  454. subdirectories, and go on from that display to select first the
  455. proper directory and then the file you want to analyze.
  456.  
  457. If your file is on another drive, first select the proper drive
  458. letter and then use the procedures described above.
  459.  
  460. If you're using a color monitor, files are presented in yellow,
  461. directories in violet, and disk drives in blue.
  462.  
  463.  
  464. Specifying Where to Store the Analysis Results
  465.  
  466. After you have specified which text you are going to analyze,
  467. you must tell the program where to store the analysis results. 
  468. The following prompt appears:
  469.  
  470. ------------------------------------------------------------
  471. Specify where to store the results (A:\)__
  472. ------------------------------------------------------------
  473.  
  474. Here, the program makes a proposal that you store your results
  475. on the diskette in drive A.  If you wish to accept the proposal:
  476.  
  477. ..  Press Enter.
  478.  
  479. However, you can also select some other drive or subdirectory. 
  480. If, for example, you wish to store your results on the diskette
  481. in drive A in a subdirectory named SPCREAD:
  482.  
  483. ..  Type:
  484.  
  485.  a:\spcread\
  486.  
  487. ..  Press Enter.
  488.  
  489. Notice that if you wish to store your results in a subdirectory,
  490. the subdirectory must have been previously established.
  491.  
  492. If you have analyzed the same text previously, the following
  493. appears:
  494.  
  495. ------------------------------------------------------------
  496. Results:  b:\text1 already exists.
  497. Do you wish to overwrite it (Y/N?)
  498. ------------------------------------------------------------
  499.  
  500. If you have no reason to preserve the previous results, you can
  501. write over them.
  502.  
  503. ..  Type:
  504.  
  505.  y
  506.  
  507. If you wish to preserve the previous results, you must enter
  508. another filename for the new results.
  509.  
  510. ..  Type:
  511.  
  512.  n
  513.  
  514. The program now prompts you as follows:
  515.  
  516. ------------------------------------------------------------
  517. Specify desired filename for results:__
  518. ------------------------------------------------------------
  519.  
  520. Type in the new filename:
  521.  
  522. ..  Type:
  523.  
  524.  NEWRES (for example)
  525.  
  526. ..  Press Enter.
  527.  
  528. The filename you choose may be any name you wish, however you
  529. are limited to eight characters.
  530.  
  531.  
  532. Specifying a Title for the Results
  533.  
  534. The following now appears on the screen:
  535.  
  536. ------------------------------------------------------------
  537. Title of results:
  538. ------------------------------------------------------------
  539.  
  540. Here, you can enter the title that you wish to give to
  541. theresults.  You might enter the author's name or a sentence
  542. that describes the text.  Whatever you enter will appear on the
  543. screen as a reference later on when you look at the results. You
  544. are permitted to enter a maximum of 53 characters.
  545.  
  546. ..  Type the desired title.
  547. ..  Press Enter.
  548.  
  549.  
  550. Selecting an Analysis Pattern
  551.  
  552. By now, the text analysis pattern menu should be on your
  553. screen.  You may choose any of the 9 styles listed against which
  554. to analyze your text:
  555.  
  556.  1.  General purpose
  557.  2.  Children's book
  558.  3.  Newspaper article
  559.  4.  Advertising copy
  560.  5.  Novel
  561.  6.  Magazine articles
  562.  7.  Technical manuals
  563.  8.  Government report
  564.  9.  Bureaucratic
  565.  
  566. If none of patterns 2-9 are suitable for your text, you should
  567. probably select pattern 1 (general purpose).  PATTERNS 7, 8 AND
  568. 9 ARE NOT TO BE CON-SIDERED GOOD EXAMPLES.  They are included
  569. simply to show how technical manuals, government reports and
  570. bureaucratic memorandums are usually written.  We hope that your
  571. writing will be better than typical examples of these.
  572.  
  573. To write a well crafted technical manual or government report,
  574. we suggest that you use style # 6 (magazine), # 3(newspaper) or
  575. # 1 (general purpose writing).  When the analysis is complete,
  576. you can examine the sentences that were found to be outside the
  577. selected pattern outline (deviant sentences).
  578.  
  579. Since the text in the example is general in nature, you will
  580. select pattern 1 (general purpose).  The program uses this as
  581. the default response.  As a result, all you have to do to select
  582. pattern 1 is to press Enter (you do not have to type in 1).
  583.  
  584. Proceed as follows to select pattern 1:
  585.  
  586. ..  Press Enter.
  587.  
  588. Sentences that fall within the pattern outline are considered
  589. normal by Readability Plus.  Any sentence that lies outside the
  590. pattern outline is considered deviant, and it is saved by the
  591. program in special result files named EXAMPLE.FX, EXAMPLE.FY and
  592. EXAMPLE.FZ.
  593.  
  594. After analysis is completed, you will be able to look at the
  595. sentences that deviate from the pattern outline.
  596.  
  597. If you wish to use pattern 1 (general purpose):
  598.  
  599. ..  Press Enter.
  600.  
  601. If you wish to use any of patterns 2-9:
  602.  
  603. ..  Type the pattern number:
  604.  
  605.  2 (For example):
  606.  
  607. ..  Press Enter.
  608.  
  609.  
  610. Checking Your Selections
  611.  
  612. Finally, you are given an opportunity to check the selections
  613. you have made.  If you have made a mistake, or if you change
  614. your mind, it's easy to start again from the beginning:
  615.  
  616. ..  Press the Esc key.
  617.  
  618. If everything is OK:
  619.  
  620. ..  Press Enter.
  621.  
  622. If you wish to make changes, return to the main menu and begin
  623. again.
  624.  
  625.  
  626. Analysis
  627.  
  628. The program now analyzes the text and saves the results on
  629. disk.  While this is happening, the "teardrop" diagram appears
  630. on the screen and the program enters a dot as each sentence is
  631. analyzed.  When the program has read and analyzed the entire
  632. text, the results are stored on disk (diskette or hard disk)
  633. under the filenames EXAMPLE.FX, EXAMPLE.FY and EXAMPLE.FZ.  If,
  634. for example, your file had been named PROPOSAL.DOC, the names
  635. would be PROPOSAL.FX, PROPOSAL.FY, and PROPOSAL.FZ.
  636.  
  637.  
  638.     BRIEF EXPLANATION OF THE ANALYSIS DISPLAY SUBMENU
  639.  
  640. Readability Plus creates a set of analysis displays that can
  641. tell you a great deal about your writing.  Before proceeding to
  642. look at the displays, it might be advisable to quickly review
  643. the options available to you on the submenu that appears at the
  644. bottom of your screen:
  645.  
  646. ------------------------------------------------------------
  647. 1Menu 2Analys 3Load 4Cntent 5Plot 6Sntnc 7Print 8Tips
  648. 9Ideal 10Help
  649. ------------------------------------------------------------
  650.  
  651. To choose a function on the submenu, simply press the
  652. corresponding function key.  To select 3Load, press F3, etc.
  653. The submenu functions are available at any time that the submenu
  654. appears on the screen.  5Plot and 6Sntnc only appear when you
  655. are looking at the text's teardrop diagram (Display 11).
  656.  
  657. 1Menu
  658.  
  659. This function permits you to exit at any time from the result
  660. display that is currently shown and return to the main menu.
  661.  
  662.  ..  Press F1.
  663.  
  664. 2Analys
  665.  
  666. Permits you to leave the currently shown result display at any
  667. time to analyze a new text.
  668.  
  669.  ..  Press F2.
  670.  
  671. 3Load
  672.  
  673. Permits you to leave the currently shown result display at any
  674. time and retrieve (load) a new Readability Plus result display.
  675.  
  676.  ..  Press F3.
  677.  
  678. 4Cntent
  679.  
  680. Enables you to call up at any time a display showing a list of
  681. all of the result displays that are available.
  682.  
  683.  ..  Press F4.
  684.  
  685. 5Plot
  686.  
  687. When the "teardrop" diagram appears on the screen, each
  688. individual sentence is represented by a dot on the diagram.
  689. When more than one sentence is represented at the same location
  690. on the drawing, the dot grows larger for each sentence that is
  691. added.  These dots can be replaced with numbers that indicate
  692. how many sentences have been plotted at each position.
  693.  
  694.  ..  Press F5.
  695.  
  696. Pressing F5 toggles between numbers and dots.  The highest
  697. number that can appear is a 9.  This means that a 9 will appear
  698. even though more than nine dots have been plotted at the
  699. position in question.
  700.  
  701. 6Sntnc
  702.  
  703. Sentences that fall outside the pattern outline that you
  704. selected are considered as deviant by the computer.  Using the
  705. arrow keys, you can move the cursor around in the teardrop
  706. diagram to mark deviant sentences.
  707.  
  708. Proceed as follows to mark a deviant sentence.
  709.  
  710.  ..  Press F6.
  711.  ..  Press Enter.
  712.  
  713. If there is more than one deviant sentence at a single position,
  714. you can press Enter repeatedly to see all of the sentences.
  715.  
  716. 7Print
  717.  
  718.  ..  Press F7.
  719.  
  720. When you select this function, the following submenu appears at
  721. the bottom of the screen:
  722.  
  723. ------------------------------------------------------------
  724. F1=Print deviant sentences F2=Print long-word runs
  725. F10=Help Esc=exit
  726. ------------------------------------------------------------
  727.  
  728. This gives you an opportunity to print out all deviant sentences
  729. in your text on the printer.  The printer prints the first words
  730. in each deviant sentence together with a page number and line
  731. number so you can find it quickly.
  732.  
  733. Proceed as follows to print out a list of the deviant sentences:
  734.  
  735.  ..  Check that the printer is ON-LINE (ready for printing).
  736.  ..  Press F1.
  737.  
  738. When printing is finished, you can leave this submenu:
  739.  
  740.  ..  Press Esc.
  741.  
  742. You can also print out a list of all long-word runs on the
  743. printer.  A word is considered long if it has seven or more
  744. letters.  A long-word run consists of one or more consecutive
  745. long words.  Only long-word runs containing three or more words
  746. are saved in the results.  Here too, the program prints out a
  747. page number and line number so that you can quickly locate the
  748. long-word runs.
  749.  
  750. Proceed as follows to print out a list of all long-word runs:
  751.  
  752.  ..  Check that the printer is ON-LINE (ready for printing)
  753.  ..  Press F2.
  754.  
  755. When printing is finished, you can leave this submenu:
  756.  
  757.  ..  Press Esc.
  758.  
  759. 8Tips
  760.  
  761. You can call up a number of useful tips for each of the result
  762. displays that you look at.  Sometimes these tips consist of
  763. ideal values that you can compare with your own writing. 
  764. Sometimes you obtain tips on how to improve your writing.  If
  765. you wish to look at the tips:
  766.  
  767.  ..  Press F8.
  768.  
  769. When you have finished reading the tips:
  770.  
  771.  ..  Press Esc.
  772.  
  773. 9Ideal
  774.  
  775. An ideal display is available for each result display that you
  776. look at.  To compare your result display with the ideal display,
  777. proceed as follows:
  778.  
  779.  ..  Press F9.
  780.  
  781. When you have finished looking at the ideal display:
  782.  
  783.  ..  Press Esc.
  784.  
  785. 10Help
  786.  
  787. Readability Plus has a built-in help function (F10) which
  788. provides you with brief, helpful information as your work
  789. proceeds.
  790.  
  791.  ..  Press F10.
  792.  
  793. When you have finished with the help information:
  794.  
  795.  ..  Press Esc.
  796.  
  797.  
  798.          UNDERSTANDING ANALYSIS RESULTS
  799.  
  800. This section explains the displays created in a Readability Plus
  801. analysis.  Here, you will learn how to call up the different
  802. displays, how to use them to your advantage, and compare your
  803. values to the ideal values.
  804.  
  805.  
  806.           SELECTING AN ANALYSIS DISPLAY
  807.  
  808. To select an analysis display, you must respond to the following
  809. prompt:
  810.  
  811. ------------------------------------------------------------
  812. Desired display:_
  813. ------------------------------------------------------------
  814.  
  815. If you know which display you wish to look at and you know its
  816. number:
  817.  
  818.  ..  Type the display's number.
  819.  ..  Press Enter.
  820.  
  821. If you do not know which display you wish to look at or if you
  822. are uncertain about its number:
  823.  
  824.  ..  Press F4.
  825.  
  826. You can now look through a list of the displays that are
  827. available.  When you have decided which one you wish to look at:
  828.  
  829.  ..  Type the display's number.
  830.  ..  Press Enter.
  831.  
  832. Browsing Among the Displays
  833.  
  834. You can also browse among the different displays by pressing
  835. PgDn and PgUp.  PgDn moves you forward to the next display.
  836. PgUp moves you back to the previous display.
  837.  
  838.  
  839.      EXPLANATION OF THE DIFFERENT ANALYSIS DISPLAYS
  840.  
  841. The different analysis displays are explained below.  Remember
  842. that you can always call up useful tips or ideal patterns via F8
  843. and F9 on the submenu.
  844.  
  845. In this section, we will use part of the first chapter from Tom
  846. Sawyer, by Mark Twain as an example that provides good analysis
  847. results.  Naturally, your writing doesn't always have to
  848. resemble Tom Sawyer, but even if you are usually writing for
  849. adults and dealing with more complicated subjects than rafting
  850. down the Mississippi, it might be a good idea to use a similar
  851. writing style.  If you wish to look at the result displays while
  852. you are reading this chapter, proceed as follows:
  853.  
  854.  ..  Start Readability Plus.
  855.  ..  Press F3 to view the Sawyer analysis.
  856.  ..  Highlight SAWYER.
  857.  ..  Press Enter.
  858.  
  859. The teardrop diagram will appear on the screen when the analysis
  860. is finished (Display 11).
  861.  
  862. Another way to get to this point is to:
  863.  
  864.  ..  Press F2 to do a new analysis
  865.  ..  Highlight SAWYER
  866.  ..  Press Enter
  867.  ..  Answer yes (Y) when you're asked if it's OK to write over
  868.      the previous analysis of SAWYER.
  869.  
  870.  
  871. Display 11 - TEARDROP Diagram
  872.  
  873. Display 11 consists of the "teardrop" diagram.  On this dia-
  874. gram, each sentence in the text is represented by a dot.  The
  875. computer positions these dots according to the number of words
  876. in the sentence and the number of long words each sentence
  877. contains.  A word is considered long if it has more than seven
  878. letters.
  879.  
  880. The series of very small dots on the diagram constitutes the
  881. "ideal curve".  This depicts the ideal relationship between
  882. sentence length and number of long words per sentence.  An
  883. asterisk (*) indicates the focal point of the text on the
  884. diagram.
  885.  
  886. Ideally, the sentences (dots) should be spread evenly to the
  887. left and to the right of the ideal curve, and the focal point
  888. falls on, or close to, the ideal curve.  Most of the sentences
  889. should lie within pattern 1 - normal diagram.  An easy-to-read
  890. text has numerous sentences near the bottom of the diagram. This
  891. means that many sentences contain only short words.  Note that
  892.  
  893. the sentences in the Sawyer diagram are arranged in such a
  894. pattern.
  895.  
  896. The Sawyer sentences are located on both sides of the ideal
  897. curve.  The focal point is located at 14.0/1.8 which is slightly
  898. to the right of the ideal curve.  Good.  There are no sentences
  899. in the upper left-hand area (where complicated sentences are
  900. plotted).  Very good.  Several sentences have been plotted out
  901. to the right in the area used for wordy and pompous sentences. 
  902. If you press F6, move the cursor to the rightmost sentence and
  903. press Enter, you will see that the first sentence in the text is
  904. located there.
  905.  
  906. To obtain an idea of what this type of writing resembles most,
  907. proceed as follows:
  908.  
  909.  ..  Study the percentages in the column to the right of the
  910.      teardrop diagram and see which pattern had the highest
  911.      percentage of matches for this text.
  912.  
  913.  ..  Press F8 to see what the different patterns are called. 
  914.      Select the desired pattern with the up or down arrow keys or
  915.      by typing in the pattern number to see how well the text in
  916.      question matches the selected pattern.
  917.  
  918. Sentences that fall within the pattern outline are considered
  919. normal by Readability Plus.  Any sentence that lies outside the
  920. pattern outline is considered deviant.
  921.  
  922. If you have a printer, you can print out a list of all of the
  923. deviant sentences.  The program presents you with the first few
  924. words in each deviant sentence and tells you the line on which
  925. the sentence is located.
  926.  
  927. Proceed as follows to print a list of the deviant sentences on
  928. the printer:
  929.  
  930.  ..  Make certain that the printer is ON-LINE (ready for
  931.      printing).
  932.  ..  Press F7.
  933.  ..  Press F1.
  934.  
  935. A list of the deviant sentences will now be printed.
  936.  
  937. You may continue by examining another result display.
  938.  
  939. Display 12 - Sentence Characteristics
  940.  
  941. Each sentence in the text is classified as one of the following
  942. types:
  943.  
  944.  ..  Simple - short sentence containing short words
  945.  ..  Normal - medium sentence containing short words
  946.  ..  Narrative
  947.  ..  Foggy
  948.  ..  Wordy - long sentence containing short words
  949.  ..  Elegant
  950.  ..  Difficult
  951.  ..  Pompous - long sentence containing long words
  952.  ..  Complicated - short sentence containing long words
  953.  
  954. Display 12 shows the percentages of each type of sentence in the
  955. text in question.  The spread around the focal point is a
  956. measure of the extent to which the sentences are spread in the
  957. teardrop diagram.
  958.  
  959. The Sawyer text contains mostly simple and normal sentences.  It
  960. is easy to read.  The spread around the focal point is greater
  961. than 8, which is good.  The bars on the diagram get shorter as
  962. one moves to the right, and this complies with the pattern found
  963. in the ideal display (press F9).  The text does not contain any
  964. complicated sentences.
  965.  
  966. If you want to learn more about focal points, spread, ideal
  967. curve, etc.  please refer to the detailed chapter in the hard
  968. cover manual you'll receive when you register the program.
  969.  
  970.  
  971. Display 13 - Long Words Per Sentence
  972.  
  973. Display 13 presents the number of long words per sentence.  If
  974. you use too many long words, your writing is difficult to read,
  975. especially if you do not use many small words to "dilute" the
  976. text.  As much as possible, you should avoid using more than
  977. nine long words in a single sentence.
  978.  
  979. You can find out how many sentences have more than a specified
  980. number of long words.  If, for example, you wish to see which
  981. sentences have more than five long words:
  982.  
  983.  ..  Type:
  984.  
  985.  5-
  986.  
  987.  ..  Press Enter.
  988.  
  989. The resulting display shows the number of long words per
  990. sentence for the Sawyer text, setting a good example for
  991. easy-to-read writing.  Most of the sentences contain 0, 1, or 2
  992. long words.  The gently rounded profile of the bars on the
  993. diagram indicates that the language used was written by a single
  994. person.  In situations where a number of people have edited the
  995. text, the pattern is usually more irregular.
  996.  
  997. Display 14 - Sentence Lengths
  998.  
  999. Display 14 presents the number of words per sentence.  People
  1000. often mistakenly believe that easy-to-read writing consists of
  1001. short sentences.  However, the results provided by Readability
  1002. Plus show that this isn't necessarily true.  Easy-to-read
  1003. writing can contain long sentences if the number of long words
  1004. per sentence is kept low.  The upper limit for sentence length
  1005. is about 35 words.
  1006.  
  1007. You can find out how many sentences have more than a specified
  1008. number of words.  If, for example, you wish to know which
  1009. sentences are longer than 35 words, proceed as follows:
  1010.  
  1011. ..  Type:
  1012.  
  1013.  35-
  1014.  
  1015. ..  Press Enter.
  1016.  
  1017.  
  1018. Display 15 - Consecutive Short Words
  1019.  
  1020. The more short words you write in succession, the easier it will
  1021. be for your reader to grasp your meaning.  Display 15 presents
  1022. the number of consecutive short words.
  1023.  
  1024. As you can see, the Sawyer text has many short words in
  1025. succession.  This improves readability.  Only about 7% of the
  1026. short-word runs contain only a single word.
  1027.  
  1028.  
  1029. Display 16 - Consecutive Long Words
  1030.  
  1031. When you write texts containing numerous facts that force you to
  1032. use long words, it is important that you avoid the use of
  1033. long-word runs.  Display 16 shows the number of consecutive long
  1034. words.
  1035.  
  1036. The display shows that more than 40% of the long-word runs
  1037. contained a single long word.  This indicates that many long
  1038. words are surrounded by short words.  Such a configuration is
  1039. extremely easy to read.  The fact that the ratio of short-word
  1040. runs to long-word runs was 7.44 indicates that the text contains
  1041. many short-word runs.  Even 3.5 would have been a good value.
  1042.  
  1043.  
  1044. Display 21 - Word Lengths
  1045.  
  1046. The words in the examined text were divided into groups based on
  1047. length.  This display shows the percentages of words containing
  1048. 1-3 letters, 4-6 letters, ..., 25 or more letters.
  1049.  
  1050. You can find out how many words of a specified length were
  1051. used.  If, for example, you wish to find out how many words had
  1052. 14 or more letters:
  1053.  
  1054. ..  Type:
  1055.  
  1056.  14-
  1057.  
  1058. ..  Press Enter.
  1059.  
  1060. If you want to find out how many words had precisely four
  1061. letters:
  1062.  
  1063. ..  Type:
  1064.  
  1065.  -4-
  1066.  
  1067. ..  Press Enter.
  1068.  
  1069. If you want to find out how many words had 4-6 letters
  1070. inclusive:
  1071.  
  1072. ..  Type:
  1073.  
  1074.  4-6
  1075.  
  1076. ..  Press Enter.
  1077.  
  1078. The word lengths in the Sawyer texts averaged 4.0 letters (a
  1079. short, therefore good, value).  The text did not contain a
  1080. single word longer than 14 letters.  That's one of the reasons
  1081. it's so easy to read.
  1082.  
  1083.  
  1084. Display 22 - Bricks
  1085.  
  1086. When Readability Plus analyzes a text, it keeps a record of all
  1087. the different words and how often they have been used.  In
  1088. Display 22, the program has segregated the 2450 most frequently
  1089. used words in the English language.  The remaining words (called
  1090. bricks) are presented in a list which also tells you how many
  1091. times each of these words was used.
  1092.  
  1093. To browse forward in this list:
  1094.  
  1095. ..  Press Enter.
  1096.  
  1097. Here, you can find all of the words that begin in a certain
  1098. way.  If you wish to look at all words in the Sawyer text that
  1099. begin with "con":
  1100.  
  1101. ..  Type:
  1102.  
  1103.  con
  1104.  
  1105. ..  Press Enter.
  1106.  
  1107. Here, you can see a number of imaginative words begin with
  1108. "con".  Moreover, you can find all the words that end in a
  1109. specified series of letters.  If, for example, you wish to look
  1110.  
  1111. at all the words that end in "ing":
  1112.  
  1113. ..  Type:
  1114.  
  1115.  ing
  1116.  
  1117. ..  Press Enter.
  1118.  
  1119. You can also find all of the words having a specified minimum
  1120. number of letters.  If, for example, you wish to look at all of
  1121. the words that have at least 13 letters:
  1122.  
  1123. ..  Type:
  1124.  
  1125.  13-
  1126.  
  1127. ..  Press Enter.
  1128.  
  1129. Moreover, you can find all of the words which, for example, have
  1130. a maximum of 5 letters:
  1131.  
  1132. ..  Type:
  1133.  
  1134.  -5
  1135.  
  1136. ..  Press Enter.
  1137.  
  1138. Finally, you can combine all four of the above.  If, for
  1139. example, you wish to find all of the words that begin with "s"
  1140. and have between 4 and 7 letters inclusive:
  1141.  
  1142. ..  Type:
  1143.  
  1144.  4-7 s
  1145.  
  1146. ..  Press Enter.
  1147.  
  1148. If, for example, you want to find all of the words that end in
  1149. "ing" and have at least 12 letters:
  1150.  
  1151. ..  Type:
  1152.  
  1153.  12- -ing
  1154.  
  1155. ..  Press Enter.
  1156.  
  1157. Remember, however, that the 2450 most frequently used words in
  1158. the English language were eliminated before making the above
  1159. analyses.
  1160.  
  1161.  
  1162. Display 23 - Mortar and Bricks
  1163.  
  1164. The 2450 most frequently used words are called mortar.  All
  1165. other words are called bricks.  Usually, a text contains around
  1166. 20% bricks.  If this percentage is higher, it indicates that
  1167. more difficult words have been selected in your text than in a
  1168. normal text.  Display 23 shows the percentages of brick and
  1169. mortar.
  1170.  
  1171. For the Sawyer text, Display 23 shows that there is a favorable
  1172. ratio between mortar and bricks.  This text has 17% bricks which
  1173. is excellent.
  1174.  
  1175.  
  1176. Display 24 - Comments on Choice of Words
  1177.  
  1178. If Readability Plus has any comments to make on the words you
  1179. have chosen to use in the text, they are presented in Display
  1180. 24.  It indicates, for example, whether you have used both
  1181. "thru" and "through" in your text.  It also indicates how many
  1182. words were needlessly prolonged, thus making your text more
  1183. difficult.  For instance, you might have used the word
  1184. "objective" when "goal" would have sufficed.
  1185.  
  1186. The comments in Display 24 are based on the list of synonyms
  1187. that is included with Readability Plus.  This list is in a file
  1188. named SYNLIST.RDB (located on your original diskette).
  1189.  
  1190.  
  1191. Display 31 - Sentence Characteristics
  1192.  
  1193. Display 31 shows how each sentence has been evaluated, starting
  1194. from the beginning of the text and proceeding sentence by
  1195. sentence.  Here, you can easily see which sentences are
  1196. "narrative" and which are "difficult".  You should compare this
  1197. with the characteristic breakdowns presented in Displays 11 and
  1198. 12.  If, in spite of their disadvantages, you must include
  1199. complicated sentences in your writing, you should make every
  1200. effort to prevent them from being bunched together.  This also
  1201. applies to pompous and wordy sentences.
  1202.  
  1203. Here, you see that the sentences in the Sawyer text vary widely
  1204. with regard to characteristics.  Only a few sentences are
  1205. pompous and they are well scattered throughout the text.  If a
  1206. text consists of more than 60 sentences, you can browse forward
  1207. as follows:
  1208.  
  1209. ..  Press Enter.
  1210.  
  1211. You can find all of the deviant sentences (those which lie
  1212. outside the area covered by the pattern outline).  If, for
  1213. example, you wish to look at all deviant sentences starting with
  1214. sentence No. 10:
  1215.  
  1216. ..  Type:
  1217.  
  1218.  10-
  1219.  
  1220. ..  Press Enter.
  1221.  
  1222. You are now provided with information about the first deviant
  1223. sentence.  To look at the next (and then the next, etc.),
  1224. proceed as follows:
  1225.  
  1226. ..  Press Enter repeatedly.
  1227.  
  1228. Displays 31 and 32 make it possible for you to find where any
  1229. "uphill slopes" occur in the text.
  1230.  
  1231. Display 32 - Long Words Per Sentence
  1232.  
  1233. Display 32 presents the number of long words per sentence.  Here
  1234. too, you can find the deviant sentences.
  1235.  
  1236. The number of long words per sentence varies considerably in the
  1237. Sawyer text.  There are only two sentences containing more than
  1238. nine long words, and they are widely separated.  This is one of
  1239. the reasons that the text is so easy to read.
  1240.  
  1241. If a text contains more than the 60 sentences shown, you may
  1242. browse forward:
  1243.  
  1244. ..  Press Enter.
  1245.  
  1246. You can find all the deviant sentences.  If you wish to look at
  1247. all deviant sentences starting with sentence No.  10:
  1248.  
  1249. ..  Type:
  1250.  
  1251.  10-
  1252.  
  1253. ..  Press Enter.
  1254.  
  1255. You are now provided with information about the first deviant
  1256. sentence.  To look at the next (and then the next, etc.),
  1257. proceed as follows:
  1258.  
  1259. ..  Press Enter repeatedly.
  1260.  
  1261.  
  1262. Display 33 - Sentence Lengths
  1263.  
  1264. Display 33 shows how long each sentence is, starting at the
  1265. beginning of the text and proceeding forward sentence by
  1266. sentence.  As a result, you can easily see how successful you
  1267. have been in varying sentence length throughout the text.
  1268.  
  1269. In the Sawyer text, sentence length varies considerably,
  1270. although you can find examples of long sentences that are
  1271. bunched together.  Text in which sentences of varying lengths
  1272. are well scattered captures and retains a reader's interest.
  1273.  
  1274. If a text contains more than the 60 sentences shown, you may
  1275. browse forward:
  1276.  
  1277. ..  Press Enter.
  1278.  
  1279.  
  1280. Display 40 - General Evaluation I
  1281.  
  1282. Display 40 presents an evaluation of the chosen text based on
  1283. the Flesch-Kincaid, Flesch Reading Ease, Gunning's Fog Index,
  1284. and LIX readability indices.  The scores given to the text based
  1285. on each of these indices are presented near the bottom of the
  1286. screen.
  1287.  
  1288. Display 41 - General Evaluation II
  1289.  
  1290. Display 41 presents a general evaluation of the following five
  1291. technical factors the text:
  1292.  
  1293. ..  Distance from the ideal curve.
  1294. ..  Spread around the focal point.
  1295. ..  Compliance with the ideal curve.
  1296. ..  Percentage of mortar.
  1297. ..  Percentage of sentences containing only short words.
  1298.  
  1299. Here, you can read the final value assigned to the text for each
  1300. factor.  For example, you can see that the distance from the
  1301. focal point to the ideal curve is 1.2.  A text's focal point is
  1302. the point on the diagram that represents the average sentence
  1303. length and the average number of long words per sentence.  (All
  1304. words containing seven or more characters are defined as long by
  1305. Readability Plus).  But to fully understand this display, you'll
  1306. need the hardcover manual which you will receive when you
  1307. register the program.
  1308.  
  1309. Each factor can be compared with the ideal factors.  To compare
  1310. the different factors, you must invoke Tips and Ideal from the
  1311. submenu.
  1312.  
  1313. Any writer could be proud of the general evaluation as good as
  1314. the one earned by the Sawyer text.
  1315.  
  1316.  
  1317. Display 42 - General Comments
  1318.  
  1319. This display presents you with advice on how to improve your
  1320. writing with regard to the percentage of long words per
  1321. sentence, the number of words per sentence and the spread ofthe
  1322. sentences on the teardrop diagram.
  1323.  
  1324.  
  1325. Display 43 - Number of Sentences and Words
  1326.  
  1327. Display 43 presents the following numeric data:
  1328.  
  1329. ..  Number of characters in text.
  1330. ..  Number of words in text
  1331. ..  Number of short words in text
  1332. ..  Number of sentences in text.
  1333. ..  Average number of words per sentence and how many of them
  1334.     are (on the average) short and long.
  1335.  
  1336.  
  1337.             LIST OF SYNONYMS
  1338.  
  1339. Display 24 identifies words in your text that are synonyms or
  1340. homonyms, and asks you to be sure you've selected the correct
  1341. word.  It also allows you to create a personal "hit list" of
  1342. words to avoid, and suggests words that might be used in their
  1343. place.  This list of words is in a file named SYNLIST.RDB, and
  1344. it is on your program diskette.  You may choose to replace our
  1345. list with one of your own, or to make it even more useful, you
  1346. may add to the list words specific to your own organization or
  1347. field.
  1348.  
  1349. Changing SYNLIST.RDB
  1350.  
  1351. You can use any word processing program which writes or converts
  1352. to ASCII to add words to or remove words from the list of
  1353. synonyms.
  1354.  
  1355. You may wish to add words in order to:
  1356.  
  1357. ..  Avoid using them.
  1358. ..  Remember explanations.
  1359.  
  1360. When you use a word that is in the list of synonyms, you may
  1361. obtain comments on it through Display 24.
  1362.  
  1363. The list of synonyms does not have any effect on your text.
  1364. This means that any words that you wish to avoid are not
  1365. eliminated automatically.  However, you are reminded of whether
  1366. or not you should use a particular word.  To make a change in a
  1367. list of synonyms, proceed as follows (for example):
  1368.  
  1369. ..  Start your word processing program.
  1370. ..  Load the program called SYNLIST.RDB
  1371.  
  1372. You may now add synonyms to or delete synonyms from the list
  1373. using the ordinary word processing procedures.
  1374.  
  1375. To make a change, proceed as follows:
  1376.  
  1377. ..  Use upper case letters for the key words.
  1378. ..  Enter the # character (if you do not have it on your regular
  1379.     keyboard hold Alt down and type 35 using the keys on the
  1380.     numeric keypad) immediately after the word in order to
  1381.     search for a synonym.
  1382. ..  Type a space immediately after the word in order to search
  1383.     for a word whose first letter is the same.
  1384.  
  1385. For each key word you can type a comment containing a maximum of
  1386. 40 characters.  You can write these using lower case letters.
  1387.  
  1388. Example:
  1389.  
  1390. ..  REGISTER - Searches for the word "register" in your text.
  1391. ..  STATION - Searches for all words that start with station.
  1392.  
  1393. A part of SYNLIST might appear as follows:
  1394.  
  1395.  PURCHASE buy
  1396.  RECORD enter (into)
  1397.  DEPOSIT save
  1398.  ACQUIRE get
  1399.  
  1400. Note!  You must save SYNLIST.RDB as a non-document or ASCII
  1401. file.
  1402.  
  1403. Creating Your Own Lists of Synonyms
  1404.  
  1405. You are permitted to have different lists of synonyms for
  1406. different types of text.  You create these lists as ordinary
  1407. word processing program documents, as described above.  However,
  1408. you must save each list as a non-document.  Remember to select
  1409. names for your synonym lists that are meaningful so that you can
  1410. retrieve them easily.  Activating One of Your Own Lists of
  1411. Synonyms
  1412.  
  1413. You can activate one of your own lists of synonyms by typing its
  1414. name when you start Readability Plus.  Suppose the desired list
  1415. of synonyms was named MYLIST.RDB.  You'd proceed as follows to
  1416. change to it:
  1417.  
  1418. ..  Type:
  1419.  
  1420.  read s=c:mylist.rdb
  1421.  
  1422. ..  Press Enter.
  1423.  
  1424.  
  1425. Installing a List of Synonyms
  1426.  
  1427. If you have DOS version 3.0 or later, it is advisable to put the
  1428. list of synonyms in the same subdirectory and disk drive as
  1429. Readability Plus.  However, you can also put the list of
  1430. synonyms in the subdirectory that is active when you start the
  1431. program.  You will find the DOS version number on the DOS
  1432. diskette that came with your computer.
  1433.  
  1434. If your version of DOS is earlier (lower) than 3.0, you can put
  1435. the list of synonyms in the directory that is active when you
  1436. start the program.  Note that this also applies to lists of
  1437. synonyms that you create yourself.
  1438.  
  1439.  
  1440.           EXITING FROM READABILITY PLUS
  1441.  
  1442. To exit from Readability Plus, you must first return to the main
  1443. menu.
  1444.  
  1445. ..  Press F1.
  1446.  
  1447. The main menu appears.  To exit from Readability Plus, you must
  1448. select Exit on the main menu:
  1449.  
  1450. ..  Press 0.
  1451. ..  Press Enter.
  1452.  
  1453. When the system prompt (A>) appears, you can remove your
  1454. diskette, concluding the Readability Plus session.
  1455.  
  1456.  
  1457.              BASIC CONCEPTS
  1458.  
  1459. In this section, we will review the basic concepts underlying
  1460. the Readability Plus program.
  1461.  
  1462.   WHAT DOES READABILITY PLUS MEASURE AND HOW DOES IT DO IT?
  1463.  
  1464. When we speak, we are able to watch our listener and observe his
  1465. reactions.  Unfortunately, this is not true when we write. 
  1466. Readability Plus gives you some idea of how readable someone
  1467. will find your writing.
  1468.  
  1469. The Readability Plus method is based on statistical procedures
  1470. that measure word length, sentence length, percentage of
  1471. commonly encountered words, and percentage of unusual words.
  1472. Essentially, there are certain factors about writing that can be
  1473. mathematically analyzed, and Readability Plus analyzes those factors.
  1474.  
  1475. Naturally, there are many other factors that affect the ease
  1476. with which a reader can understand the message we are trying to
  1477. get across.  For example, Readability Plus has no way of knowing
  1478. how familiar the reader is with the subject at hand, how
  1479. interested he is in it, or his general level of education. 
  1480. Syntax errors that flaw the structure of a sentence and unclear
  1481. references within sentences are also examples of factors that
  1482. Readability Plus cannot measure.  However, it does provide you
  1483. with a useful and objective measure of the quality of your
  1484. writing.  One could say that a good readability rating is a
  1485. necessary but not an all-embracing factor of a document.
  1486.  
  1487. While creating Readability Plus, Roland Larson analyzed
  1488. approximately 600,000 words in texts taken from many different
  1489. fields.  These analyses showed that texts which we consider easy
  1490. to read earn good readability ratings, while texts that people
  1491. consider difficult to read and to understand fail to earn good
  1492. ratings.  One example of good writing is the excerpt from Tom
  1493. Sawyer, by Mark Twain, used in this manual.
  1494.  
  1495.  
  1496.             LANGUAGE BUILDING BLOCKS
  1497.  
  1498. Writing can be compared with building a brick wall.  Here, the
  1499. bricks form the wall itself, but in order to join them together,
  1500. you must use plenty of mortar.  The ratio of bricks to mortar
  1501. must be properly balanced in a stable, well-built wall.  In
  1502. language, we use many small words and bridging words that serve
  1503. as mortar.  All other words are considered bricks.
  1504.  
  1505. Readability Plus contains the 2450 most frequently used words in
  1506. the English language.  They are considered mortar, and all other
  1507. words are considered bricks.
  1508.  
  1509.  
  1510. Bricks
  1511.  
  1512. Bricks are the words that carry the information we wish to
  1513. convey.  The following are examples of bricks:
  1514.  
  1515.  snowstorm, twilight, television, chimney, computer.
  1516.  
  1517. Any sentence that contains more than ten bricks will probably be
  1518. difficult to understand.
  1519.  
  1520. Mortar
  1521.  
  1522. What percentage of a text is normally made up of commonly used
  1523. words?
  1524.  
  1525. ..  The four most frequently used words (and, in, that, a) make
  1526.     up 10% of a text.
  1527. ..  The ten most frequently used words make up 20% of a text.
  1528. ..  The twenty most frequently used words make up 30% of a text.
  1529. ..  The 450 most frequently used words make up 60% of a text.
  1530. ..  The 2450 most frequently used words make up 80% of a text.
  1531.  
  1532. If you want your writing to be pleasant and easy to read, you
  1533. must use plenty of mortar.  In good writing, bricks and mortar
  1534. are properly balanced.  A sentence that contains too many bricks
  1535. will be somewhat foggy and perhaps complicated.  A sentence
  1536. having too much mortar will be wordy.  However, situations do
  1537. arise in which a sentence containing only short words is needed
  1538. to provide a "break" in the text so that the reader will be able
  1539. to recover his capacity to digest a highly informative section.
  1540.  
  1541. Readability Plus measures the ratio of bricks to mortar and, if
  1542. properly balanced, the program will issue a good rating.
  1543.  
  1544.  
  1545. Misconceptions About Sentence Length
  1546.  
  1547. People often mistakenly conclude that short sentences are needed
  1548. for good readability.  However, short sentences must not become
  1549. an objective in themselves.  There is no reason not to write
  1550. long sentences (though not too long).  Mixing short and long
  1551. sentences together is good practice.  However, it is important
  1552. to note that sentences should not contain too many long words.
  1553.  
  1554.  
  1555. Teardrop Diagram
  1556.  
  1557. Readability Plus measures the total number of words and the
  1558. number of long words in each sentence.  (A long word is a word
  1559. having seven or more letters.) Each sentence is assigned a
  1560. characteristic depending on where it is located in the teardrop
  1561. diagram.
  1562.  
  1563. ..  A simple sentence is quite short and contains only a few
  1564.     long words.
  1565. ..  A complicated sentence is quite short and contains many long
  1566.     words.
  1567. ..  A wordy sentence is long and contains only a few long words.
  1568. ..  A pompous sentence is long and contains many long words.
  1569.  
  1570. When you analyze a text, you select the pattern against which
  1571. you want your sentences to be evaluated.  Readability Plus has
  1572. nine patterns for different types of texts (newspaper articles
  1573. or technical manuals for example).
  1574.  
  1575. Each sentence that falls outside the selected pattern outline is
  1576. classified by the program as deviant.  These deviant sentences
  1577. are of particular interest to you, since they do not comply with
  1578. the intended type of writing.
  1579.  
  1580. Readability Plus permits you look at all deviant sentences very
  1581. conveniently.  You'll see on the screen the beginnings of the
  1582. sentences and their locations in the text.  If you have a
  1583. printer connected to your computer, you can also print out a
  1584. list of all deviant sentences.  Here too, you will be provided
  1585. with information that enables you to find them quickly in the
  1586. text.
  1587.  
  1588. Good writing requires sentence variation.  There is as much a
  1589. rhythm to writing as there is to music or anything else in life.
  1590. It is this "ebb and flow" that makes writing sing!  Long and short
  1591. sentences should be interspersed and they should contain a variety
  1592. of long words, medium length words, and short words.  The ideal
  1593. area on the teardrop diagram contains the following types of sentences:
  1594.  
  1595.  normal, simple, somewhat foggy, narrative, difficult, and
  1596.  elegant
  1597.  
  1598. Sentences that are wordy, complicated, or pompous fall outside
  1599. the ideal area.
  1600.  
  1601.  
  1602. Does Readability Plus Measure Grammar Usage?
  1603.  
  1604. Different grammatical configurations affect sentence length and
  1605. word length in different ways; this is reflected in the
  1606. "teardrop" diagram.  Readability Plus does not measure
  1607. grammatical usage in and of itself, but the effects of certain
  1608. grammatical configurations are measured.  Poorly composed
  1609. sentences are positioned in the upper left-hand part of the
  1610. "teardrop" diagram.  This is why you should have access to either an
  1611. editor or a grammar checker, or have a good command of the English
  1612. language yourself.
  1613.  
  1614.  
  1615.      MORE THAN YOU WANTED TO KNOW ABOUT READABILITY INDICES
  1616.  
  1617. Most writing experts don't like readability formulas.  They warn
  1618. you that readability indices should be used very cautiously; and
  1619. that you should place too much reliance on them.
  1620.  
  1621. It's important to realize that nearly all readability indices
  1622. measure the same two variables:  average sentence length (in
  1623. words) and average word length (in syllables or characters). 
  1624. What's different is how the results are computed and reported.
  1625.  
  1626. While these two factors are very important for ensuring easy
  1627. readability, other factors such as vocabulary choice are just as
  1628. important.  That's why we feel that our Mortar and Bricks
  1629. display is at least as important as our display of readability
  1630. indices.
  1631.  
  1632. It's also important to realize the existing evidence links 
  1633. readability scores to increased comprehension is very
  1634. sparse.  Nearly all the original research was done on school
  1635. children and military enlisted men, and even then the results
  1636. were mixed.  Only a few studies have tried to validate the
  1637. scales' use with college graduates, and these results are even
  1638. more mixed.  However, it is interesting to note that mass media
  1639. that achieve large circulations or large audiences have readability
  1640. levels in the 5th-7th grade.
  1641.  
  1642. Nevertheless, if it's critical that your readers understand what
  1643. you've written, there's still no substitute for testing your
  1644. material on a small sample of people before distributing it across
  1645. the entire company or nation.
  1646.  
  1647. All that being said, readability indices are here to stay; the federal
  1648. government and many states mandate that certain documents achieve
  1649. certain readability levels.  And Readability Plus allows you to compute
  1650. the most popular and most widely-accepted readabilty indices. It's the
  1651. only product on the market (with the exception of Corporate Voice,
  1652. developed from Readability Plus) that links the scores to the purpose
  1653. of your writing.  Therefore, if you're going to compute readability
  1654. indices, it's best done with these programs and a whole heck of a lot
  1655. easier than doing it by hand.
  1656.  
  1657. Please, look at all of the displays the program produces and
  1658. don't give undue weight to the indices.  The "teardrop"
  1659. scattergrams give you much more information from the same
  1660. variables; the mortar and bricks display gives you a more useful
  1661. revision tool; and the displays that focus on how long/short
  1662. words and sentences are intermixed are much better for helping
  1663. you keep your readers' interest.
  1664.  
  1665. Now that we've given you the warnings, here's a little more
  1666. information about the indices included in Readability Plus.
  1667.  
  1668.  
  1669. Flesch-Kincaid Index
  1670.  
  1671. This index is the one specified by many federal agencies,
  1672. including the Defense Department and the IRS.  It uses grade
  1673. levels as its measure.  Thus a score of 6.7 means that a student
  1674. whose reading score on a standardized test is in the 7th month
  1675. of the 6th grade should be able to read the text.
  1676.  
  1677.  
  1678. Flesch Reading Ease Index
  1679.  
  1680. Many states use this index to analyze insurance policies.  It
  1681. uses a scale of 1-100 and goes in the opposite direction from
  1682. all the other formulas, with high scores indicating very easy
  1683. texts and low ones meaning that the selection is very
  1684. difficult.  Insurance policy regulations typically require a
  1685. score of 40 or higher.
  1686.  
  1687.  
  1688. Gunning's Fog Index
  1689.  
  1690. Like Flesch-Kincaid, the Gunning's Fog Index uses grade levels
  1691. as its measure.  It's a lot "tougher" however.  A text that
  1692. scores 7.9 on the Flesch-Kincaid may score 10.9 or higher on the
  1693. Gunning's Fog Index.
  1694.  
  1695.  
  1696. LIX
  1697.  
  1698. A variation of Gunning's Fog Index, LIX is a popular index in
  1699. Scandinavia.  If you divide its scores by 2.5, you'll get the
  1700. American grade level equivalent of the selection.
  1701.  
  1702. More detailed descriptions of the readability indices, as well
  1703. as the mathematical proofs and formulas, are in the manual that
  1704. will be provided to you if you register your program.
  1705.  
  1706.            WHY I SHOULD UPGRADE TO CORPORATE VOICE
  1707.  
  1708. When it was released in 1989, Readability Plus was the most
  1709. powerful text analysis program available.  The only product
  1710. that has surpassed its ability is its successor Corporate Voice.
  1711. When dealers and the press saw Corporate Voice at the COMDEX
  1712. computer show, the response was phenomenal!  A well-known
  1713. columnist commented:
  1714.  
  1715. "Corporate Voice represents an entirely new category of
  1716. software.  It may have as profound an effect on corporate
  1717. writing as Lotus 1-2-3 had on corporate planning."
  1718.  
  1719. We think he's right.  But just as the "bean counters" had to
  1720. understand what Lotus 1-2-3 would do for them, writers and business
  1721. people who earn their living by writing need to understand what
  1722. Corporate Voice can do for them.  That's one of the primary reasons
  1723. why we released Readability Plus Version 2.0 into shareware.
  1724.  
  1725. Originally, Corporate Voice was just a "style-building engine"
  1726. that would let you add your own writing styles to a new version
  1727. of Readability Plus.
  1728.  
  1729. However, as we experimented with the engine, we found that by
  1730. adding some features, we could provide an entirely new kind of
  1731. writing tool -- A WRITING STYLE REPLICATOR -- that lets
  1732. organizations produce higher quality writing in much less time
  1733. and with a heck of a lot less frustration and agony.
  1734.  
  1735. An individual's writing, until this point, could not be analyzed
  1736. like an equation.  There was no objective way to pinpoint the
  1737. difficult areas in the writing.  Generally, the result was a
  1738. statement by a supervisor or professor such as: "This report has
  1739. all the necessary information, but it's missing something.  I
  1740. can't put my finger on it, but there is definitely something
  1741. missing."
  1742.  
  1743. But we found what was missing -- the rhythm and the flow -- those
  1744. important things that determine a well written document from
  1745. one that isn't.  There is a rhythm to everything in life -- in
  1746. music, in nature, everything.  Even writing has a rhythm, but it
  1747. is difficult to pinpoint what makes writing "sing!"  Corporate Voice
  1748. found a way to do that.  Most people have the ability to write well;
  1749. they just need to fine tune some things.  Corporate Voice shows them
  1750. where to fine tune and gives advice on how to do the fine tuning.
  1751.  
  1752. Our tests show that Corporate Voice allows many writers to
  1753. double their productivity.  It also saves managers as much as
  1754. 80% of the time they spend reviewing drafts and cuts their
  1755. associated frustration by nearly 100%.  (Some people are just ALWAYS
  1756. going to be a little bit frustrated; Corporate Voice doesn't change a
  1757. person's behavior patterns so we can't help them!)  And, because
  1758. writers and managers understand what's needed right from the
  1759. start, they emerge from high-pressure writing assignments on
  1760. good terms, and more confident and relaxed than ever before!
  1761.  
  1762. We were so encouraged by these results that we built all of
  1763. Readability Plus' capabilities into Corporate Voice. Here are
  1764. just some of Corporate Voice's features:
  1765.  
  1766. You can create style models from what you (or your competitors)
  1767. have written.  Corporate Voice can read the newest versions of
  1768. WordPerfect, Microsoft Word, WordStar, WordStar 2000 or ASCII
  1769. text files.  Even on an XT-class personal computer, Corporate Voice
  1770. is really fast.  If you really wanted to, you could build a style
  1771. model from as many as 100 documents in less than 10 minutes!  Once
  1772. created, you can "protect" styles so that others can use them, but
  1773. only you can change them.
  1774.  
  1775. You can identify "trade words" and calculate "corrected
  1776. readability indices."  Thus, you can use it to create technical
  1777. documentation for those less fortunate than you who may not have the
  1778. benefit of an advanced education.  (Personally, we truly hope you do!)
  1779. When you create a style, you can designate difficult words that your
  1780. audience understands as trade words (e.g., gas station attendants with
  1781. 3rd grade reading levels can read the word "carburetor").  Then, when
  1782. it calculates readability indices such as the Flesch-Kincaid, you receive
  1783. two readability scores:  the standard index, and a corrected index that
  1784. assumes your audience understands the trade words you've designated and
  1785. doesn't penalize you for using those words.
  1786.  
  1787. You can establish easily-enforced standards for good writing.
  1788. All you need to know is which documents have worked successfully
  1789. in the past.  Then you can establish standards: "All Final
  1790. Reports must score at least 90% on the Corporate Final Report style
  1791. and have a corrected Flesch-Kincaid index of 6.5 or less." You can
  1792. match your text to the style model on more
  1793.  
  1794. than a dozen measures of sentence structure, vocabulary and reading
  1795. difficulty. Readability Plus only provides comparisons between your
  1796. text and the style on the teardrop display.  Corporate Voice gives you
  1797. direct comparisons on nearly all of its 17 displays.  It's a very objective
  1798. way to analyze reports.  People tend to take criticism of their writing
  1799. very personally -- this is one way to keep personalities out of the
  1800. analysis process.
  1801.  
  1802. Sounds a bit difficult, you say?  Not on your life!  You can master
  1803. Corporate Voice quickly, thanks to a completely new manual (which we ran
  1804. through Corporate Voice) and more than 50 context-sensitive help screens. It
  1805. will take most people about an hour to master the program, but if you've
  1806. used Readability Plus, it should take you no more than 20 minutes.
  1807.  
  1808. The real power of Corporate Voice is its ability to build writing style
  1809. from documents YOU choose.  But if you are into immediate gratification and
  1810. just can't wait, you can use the expanded set of pre-programmed style models
  1811. included with the program.  We've added a user manual style, a legal style
  1812. and the styles of several best-selling authors including Ian Fleming,
  1813. Tom Clancy, and Louis Lamour.  You can even "clone" the style of bureaucratic
  1814. gobbledegook if that is your wish!
  1815.  
  1816. You can enjoy many other improvements, including an attractive
  1817. storage case and a much larger "hit list' of words to avoid or
  1818. be wary of using.
  1819.  
  1820. Corporate Voice has a list price of $249.95.  To order, just call our
  1821. 24-hour order line at 1-800-4 U.S. SPCS (487-7727) and use your credit card.
  1822. Or, you can print out the order form from the file called REGISTER and send it
  1823. to us at Scandinavian PC Systems, Inc., 6 Nelson Street, Rockville,
  1824. MD 20850-2130.
  1825.  
  1826. If you're not ready yet for Corporate Voice, but think you may
  1827. wish to purchase it in the future, we suggest you register the
  1828. Readability Plus program.  As part of your registration package,
  1829. you'll receive a rebate coupon good for $15 off on Corporate
  1830. Voice.  This coupon is good no matter where you purchase the
  1831. program; simply send it to us with a proof of purchase after you do
  1832. decide to buy Corporate Voice and we'll send you $15, which you may spend
  1833. as you so please.  Or, if you wish, you may donate it to Project Literacy
  1834. U.S., Read To Achieve, Reading is FUNdamental, or the Literacy Volunteers
  1835. of America (hint, hint).
  1836. 
  1837.